Skip to content

Conversation

hasparus
Copy link
Contributor

@hasparus hasparus commented Aug 13, 2025

Description

Howdy. I updated the landing page according to the new designs discussed in graphql/community-wg#21.

If you're interested in reading it step by step in chunks bigger than one commit, you can find the PRs reviewed by @saihaj in my fork hasparus/graphql.github.io/pulls?q=is+new-landing+.

image

hasparus and others added 5 commits August 16, 2025 03:00
Co-authored-by: Benjie <benjie@jemjie.com>
Co-authored-by: Benjie <benjie@jemjie.com>
* Extract edges and boxes out from the components.

* Make diagram boxes and edges responsive

* Make the diagram less tall

* Animate client edge on small screens

* Animate server edges on small screens

* Remove next step on background click per Uri's request

* Rotate query sideways on small screens
Co-authored-by: Benjie <benjie@jemjie.com>
@hasparus
Copy link
Contributor Author

Hey @benjie, I've applied your suggestions, so we're down to #2078 (comment)

Could you tell me if the texts in the green use cases section are okay?

image

I'm also not sure about this:

Every GraphQL service defines a type system, enabling tools to syntactically validate queries before execution and ensuring predictable responses.

I know I'm being annoying, but GraphQL spec defines a type system, right? The service defines data types with a schema.

* Add [Try it out] link to the Hero

* Add redirect from /docs to /learn
Copy link
Contributor

@martinbonnin martinbonnin left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A few comments but looks great!
Thanks for spearheading this!

Comment on lines +20 to +22
"Deliver high-performance user experience at any scale",
"Secure and stabilize your API with a strongly typed schema and validated requests",
"Reduce communication overhead through efficient, distributed development",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm late to the party but this is a lot of words for my limited brain. Proposal for simplification:

Suggested change
"Deliver high-performance user experience at any scale",
"Secure and stabilize your API with a strongly typed schema and validated requests",
"Reduce communication overhead through efficient, distributed development",
"High-performance at any scale",
"Typesafe schemas, secure requests",
"Frictionless distributed development",

My logaf is low and this has probably been bikeshedded already, feel free to discard my comment.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I love the shortening
the first sentence though was suppose to talk about creating UI at scale, like data co-location stuff
I wonder how we can capture that in a short sentence?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

New attempt with Data driven UI at scale

Suggested change
"Deliver high-performance user experience at any scale",
"Secure and stabilize your API with a strongly typed schema and validated requests",
"Reduce communication overhead through efficient, distributed development",
"Typesafe schemas, secure requests",
"Frictionless distributed development",
"Data driven UI at scale",

I am also moving it last because it's a consequence of the first two IMO. If I'm coming to graphql.org and the first thing I see is about UIs, it would have tripped me up.

GraphQL is an open‑source query language for APIs and
a&nbsp;server‑side runtime. It provides a strongly‑typed schema to
define relationships between data, making APIs more flexible and
predictable. And it isn’t tied to a specific database or storage
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
predictable. And it isn’t tied to a specific database or storage
predictable. GraphQL isn’t tied to a specific database or storage

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants